メインコンテンツまでスキップ
バージョン: DAI 7.2

WindowsでEggplant DAIをインストールまたはアップグレードする

このセクションでは、Windows で Eggplant DAI をインストール、アップグレード、ライセンス認証するための手順を段階的に説明します。インストール プロセスを開始する前に、サポートされているオペレーティング システムと推奨されるインストール構成に関する情報について、前提条件 を必ずお読みください。

ノート

DAI 7.1 のリリース後、システム要件とサポートされるオペレーティング システムの情報は 前提条件 ページに移動されました。 EPF インストール用のシステム設定の詳細については、このページを参照してください。

Windows、Mac、Linux に EPF をインストールする手順は次のとおりです。

標準とアドバンスのインストール

Eggplant DAIのWindowsインストールは標準またはアドバンスのどちらかを選択できます。アドバンスインストールでは、いくつかの追加設定が可能です:

  • デフォルトのポート設定を更新し、HTTPSを設定する
  • PostgreSQLのデータが格納されるディレクトリを選択する
  • Eggplant Functionalのスイートが保存されるディレクトリを選択する。

両方のインストールタイプに対して、インストールを開始するのステップに従い、適切なセクションにジャンプします。

Eggplant DAIのインストール

Eggplant DAIのWindowsインストールは次をサポートしています:

  • 新規インストール
  • 前のサポートバージョンからの段階的なアップグレード(サポート バージョンの完全なリストについては、リリースノートを参照してください)。
  • ダウングレードはサポートしていません。
重要

アップグレードする場合は、インストールを開始する前に、必ずすべての DAI サーバーとサービスを停止し、ファイルとデータをバックアップしてください。ご質問がある場合、またはアップグレード前のデータベースのテストについてサポートが必要な場合は、テクニカル サクセス マネージャーまたは弊社の カスタマー サポート までお問い合わせください。

バックアップを取るには:

  1. すべての DAI サーバーとサービスを停止します。 Windows サービス マネージャーを使用して Digital Automation Intelligence Service を停止します。
  2. C:\ProgramData\Eggplant\Digital Automation Intelligence を開き、ProgramData ディレクトリの外にある data フォルダーと minio フォルダーを別のマシンまたはバックアップ デバイスにコピーします。
  3. Digital Automation Intelligence Serviceを再起動します。

最新のDAIリリースにアップグレードした後で再インストールする必要がある場合は、別のバックアップを作成し、元のファイルを復元します。

  1. トラブルシューティングに役立つ可能性があるDAIファイルとデータのバックアップを作成するため、上記の手順1と2を繰り返します。
  2. Windows Services managerを通じてDigital Automation Intelligence Serviceを停止します。
  3. C:\ProgramData\Eggplant\Digital Automation Intelligenceを開き、以前のマイナーDAIリリースからバックアップした元のバージョンのdataおよびminioフォルダで上書きします。
  4. Digital Automation Intelligence Serviceを再起動します。

インストールを開始する

新規インストールまたは前のマイナーDAIリリースからのアップグレードにこれらの指示を使用します。

  1. Eggplant DAI インストール ファイルをダウンロード

  2. インストールファイルを右クリックして、Run as Administratorオプションを使用してSetupウィザードを起動します。続行するにはNextをクリックします。

    :::注意点

    DAIのインストーラーは可能な限り管理者として実行することをお勧めします。これにより、DAIは正しい権限でインストールされます。

    まだ行っていない場合は、Eggplant DAIをアンインストールするように求められることがあります。

    :::

  3. デフォルトのインストールディレクトリ C:\Program Files\Digital Automation Intelligence を保持するか、参照... をクリックして別の場所を選択します。

  4. 高度なインストーラーオプション画面で、以下のどちらかを行います。

標準インストールの実行

前提条件: インストールを開始するのすべての手順を完了します。

  1. サーバー&管理設定画面で、以下を入力します。

    • DAIサーバーホスト名: URLの主要なDAIサーバーのホスト名。ホスト名に http://https:// の接頭辞は含めないでください。

      • サーバーがローカルマシンである場合は、localhostと入力します。これは、Eggplant DAIは http://localhost:8000 からのみアクセスできることを意味します。
      • DAIサーバーに他のリモートマシンからアクセスする必要がある場合は、完全なドメイン名(例:www.serverhostname.com)を入力します。これにより、例えば http://<serverhostname>:8000 からブラウザでEggplant DAIにアクセスできます。
      ヒント

      サーバーのホスト名を調べるには、設定 > システム > このPCについてに移動します。

    • システム管理者の詳細: Eggplantのアイデンティティアクセス管理システム(IAM)の管理者の資格情報。

      • ユーザー名: < > \ / { } " % ! ^ と大文字を除いたASCII印刷可能な文字のみを入力します。
      • パスワード: " \ { } % ! ^ を除いたASCII文字を使用して、12から128文字の間で入力します。 :::info 重要
      重要

      システム管理者アカウントの資格情報は安全な場所に保管してください。特定の状況下では、Eggplant のテクニカル サクセス マネージャーが、それらを見つけて使用するように依頼する場合があります。

    • DAI管理者の詳細: DAI管理者の資格情報と個人詳細。

      • ユーザー名: < > \ / { } " % ! ^ と大文字を除いたASCII印刷可能な文字のみを入力します。
      • パスワード: " \ { } % ! ^ を除いたASCII文字を使用して、12から128文字の間で入力します。

      :::注意点

      はじめてEggplant DAIにログインするときや、他のユーザーを作成または更新するときには、DAI管理者の資格情報が必要です。ログインしたら、上記の除外された文字と他の言語や文字(例:ユニコード)を含めてパスワードを更新できます。管理者のユーザー名は更新できません。

      DAI でシングル サインオン (SSO) 認証を使用する場合は、初回ログインとライセンス で説明されているように、DAI バージョン 7.1 以降をインストールした「後」に構成します。および シングル サインオン (SSO) 認証と DAI の統合

      :::

  2. スタートメニューフォルダーの選択画面に進むには、次へをクリックします。

  3. Eggplant DAIへのショートカットの別の場所を選択するには、デフォルトの設定を受け入れるか、**参照…**をクリックします。

  4. インストール準備完了画面に進むには、次へをクリックします。インストールを開始するには、インストールをクリックします。

  5. インストールが完了したら、DAI Windows Service Start-up画面が表示され、ここでDAIサービスが初めて開始されます。このプロセスは最大10分かかる場合があり、必要に応じてマイグレーション活動が含まれる場合があります。

  6. HTMLのDAI Windows Service Start-up Reportがデフォルトのインターネットブラウザで開かれ、正常に開始されたサービスがリストされます。すべてのDAIサービスが正常に開始されたというStart-up Reportに示されている場合、マイグレーションプロセスは正常に完了しています。起動中に発生するエラーは、トラブルシューティングの補助のためにここで詳細に説明されます。

  7. セットアップが完了したら、Finishボタンをクリックします。

  8. DAIサービスが正常に起動できない場合は、Windowsサービスマネージャを通じてDAIサービスを再起動するか、PCを再起動する必要があります。

  9. First Log in and Licensingに進む。

高度なインストールの実行

事前条件:

  • Start Your Installationのすべてのステップを完了する。
  • Eggplant DAIサーバーのHTTPSを設定するには、信頼できる証明書とキーが必要です。信頼できる証明書はMozillaのページに記載されている証明機関から発行されます:
    • PEM形式のTLS証明書: 有効な証明書のリストについては、Mozillaページを参照してください。
    • PEM形式のSSLキー: nginxが受け付けるすべてのキーフォーマット。
ノート

Windows環境では、証明書はブラウザまたはエージェントを実行しているマシンに信頼されたルート認証機関としてインストールされている別の証明機関によって署名できます。

自己署名SSL証明書を使用する場合は、インストール後に設定を更新する必要があります。次のように設定します:

  • _発行者_を証明書を発行する組織、たとえば"yourcompanyname"に設定します。
  • サブジェクト_は証明書が生成されたホスト名、たとえば"local.dai.com"に設定し、インストール中に入力したホスト名と一致する_必要があります

ChromeとFirefoxで受け入れられるためには、エンドエンティティ証明書はSubject Alternative NameフィールドとAuthority Key Identifierフィールドを設定する必要があります。現在はsha512が十分に強力なハッシュ関数を使用しています。

  1. PostgresSQL Data Directory画面では、次のいずれかを選択します:

    • デフォルトのパスを受け入れるには、Nextをクリックします。
    • 別のディレクトリを選択するには、Browseをクリックします。たとえば、DAIデータベースのカスタムロケーションを使用するには、C:\MyCompany\Dataに移動します。
    重要

    DAIはWindowsのlocal systemアカウントの下で動作します。このアカウントが選択したディレクトリに書き込む権限を持っていることを確認する必要があります。そうでなければ、インストールが失敗します。新しいフォルダを作成をクリックすると、別のデ イレクトリを選択したときに適切な権限が設定されることが確認できます。

  2. Server Port & HTTPS画面に進むには、Nextをクリックします。

  3. デフォルトのポート値8000を保持します。このポートが使用できない場合や、代替のポートを使用する必要がある場合は、インストール後にいつでも設定を更新できます。

    :::注意点

    ポート80は、HTTPまたはHTTPSの設定のいずれにも現在サポートされていません。

    :::

  4. DAIサーバーを安全にするためにHTTPSを設定したくない場合は、HTTPSを使用のチェックボックスをクリアし、次へをクリックし、そのままステップ6に進みます。それ以外の場合は、HTTPSを使用のチェックボックスを選択したまま、次のステップに進みます。

    • ポート8000が利用可能な場合は、デフォルト値をそのままにします。
    • ポート8000が利用できない場合は、使用するHTTPポートを入力します。
  5. 証明書の詳細を追加します:

    • **HTTPS証明書:**HTTPS証明書をブラウズして選択します。
    • **HTTPS Private Key:**HTTPSキーファイルをブラウズして選択します。
    • **(オプション)プライベートキーにはパスワードが必要:**プライベートキーを解除するためにパスワードが必要な場合は、このオプションを選択し、パスワードファイルをブラウズして選択します。
  6. 次へをクリックして使用統計画面に進みます。次のメトリクスを収集するためにEggplantに許可を与えるためにチェックボックスを選択したままにします:

    • 製品識別子
    • 製品バージョン
    • ホストOS
    • ホストOSバージョン
    • ライセンス(シリアル番号)情報。
  7. 次へをクリックしてSuites Data Directory画面に進みます。次のいずれかを選択します:

    • デフォルトのパスを受け入れるには、再度次へをクリックします。
    • Eggplant Functionalスイートの別のディレクトリを選択するには、ブラウズをクリックします。これは、エージェントがスイートをアップロードするディレクトリで、現在それらを保存している場所とは異なる可能性があります。
    重要

    DAIはWindowsのlocal systemアカウントの下で動作します。このアカウントが選択したディレクトリに書き込む権限を持っていることを確認する必要があります。そうでなければ、インストールが失敗します。新しいフォルダを作成をクリックすると、別のディレクトリを選択したときに適切な権限が設定されることが確認できます。

  8. 標準インストールの全ての手順を完了します。

初回ログインとライセンス認証

Eggplant DAI がインストールされて実行されている場合、ブラウザからアプリケーションにアクセスする必要があります。次の手順に従って、ログインし、ライセンスを取得し、Eggplant DAI の使用を開始します。

  1. ブラウザから適切なURLを入力してログイン画面を表示します:

    • インストール中にホスト名localhostを追加した場合は、Eggplant DAIサーバーが実行されているコンピューターからブラウザを起動し、http://localhost:8000を入力します。
    • インストール中に完全なホスト名を追加した場合、リモートマシンからEggplant DAIサーバーにアクセスすることができます。ブラウザを起動し、http://<serverhostname>:8000を入力します。
  2. Eggplant DAIがログインを求めます。インストール中に設定したDAI管理者アカウントのユーザー名とパスワードを入力し、OKをクリックします。

  3. ライセンスページで、ライセンスキーを入力し、同意をクリックします。Eggplant Software License agreementのコピーは、同意をクリックする前に読んでダウンロードすることができます。ライセンスは、Keysight Software Manager (KSM)で生成できます。ライセンスが受け入れられた後、新規DAIユーザーが自分のパスワードを設定できるようにメールを設定するための**設定**ページが表示されます。このステップはスキップすることができますが、その場合は一時的なパスワードをユーザーに提供する必要があります。

  4. ユーザーアカウントの更新を行うことができます。Eggplant DAIインターフェースの左メニューでAccessをクリックします。

ノート

DAI で Microsoft Active Directory (AD) によるシングル サインオン (SSO) 認証を使用する場合は、「シングル サインオン (SSO) 認証と DAI の統合」(dai-sso-integration.md) を参照してください。

  1. 新しいブラウザタブで管理コンソールを開くには、ユーザー管理をクリックします。
  2. ユーザーを編集するには、検索ボックスにユーザー名の最初の数文字を入力して一致するユーザーを見つけ、正しいレコードのIDをクリックします。
  3. あなたのメールアドレスを入力し、保存を選択します。
  4. 管理環境について詳しく知りたい場合は、ユーザーの管理セクションに進んでください。または、初めてアプリケーションを使用する場合は、はじめにを参照してください。